package com.example.demo.mapper;

import com.example.demo.entity.User;
import org.apache.ibatis.annotations.*;
import org.springframework.stereotype.Repository;

import java.util.List;

@Mapper
@Repository
public interface UserMapper {
    
    /**
     * 根据用户ID查询用户
     * @param user_no 用户ID
     * @return 用户对象
     */
    User findById(int user_no);
    
    /**
     * 根据用户名查询用户
     * @param name 用户名
     * @return 用户对象
     */
    User findByName(String name);
    
    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<User> findAll();
    
    /**
     * 插入新用户
     * @param user 用户对象
     * @return 影响行数
     */
    int insert(User user);
    
    /**
     * 用户登录
     * @param name 用户名
     * @param password 密码
     * @return 用户对象
     */
    User login(@Param("name") String name, @Param("password") String password);
    
    /**
     * 更新用户信息
     * @param user 用户对象
     * @return 影响行数
     */
    int update(User user);
    
    /**
     * 删除用户
     * @param user_no 用户ID
     * @return 影响行数
     */
    int delete(int user_no);
    
    /**
     * 更新用户密码
     * @param user_no 用户ID
     * @param newPassword 新密码
     * @return 影响行数
     */
    int updatePassword(@Param("user_no") int user_no, @Param("newPassword") String newPassword);
    
    /**
     * 根据角色查询用户
     * @param role 角色
     * @return 用户列表
     */
    List<User> findByRole(String role);
    
    /**
     * 根据条件查询用户
     * @param condition 条件
     * @return 用户列表
     */
    List<User> findByCondition(@Param("condition") String condition);
    
    /**
     * 分页查询用户
     * @param offset 偏移量
     * @param limit 限制数
     * @return 用户列表
     */
    List<User> findByPage(@Param("offset") int offset, @Param("limit") int limit);
    
    /**
     * 统计用户总数
     * @return 用户总数
     */
    int count();
    
    /**
     * 分页搜索用户
     * @param offset 偏移量
     * @param limit 限制数
     * @param field 搜索字段
     * @param code 搜索关键词
     * @return 用户列表
     */
    List<User> findByPageAndSearch(@Param("offset") int offset, @Param("limit") int limit, 
                                   @Param("field") String field, @Param("code") String code);
    
    /**
     * 统计搜索结果总数
     * @param field 搜索字段
     * @param code 搜索关键词
     * @return 搜索结果总数
     */
    int countBySearch(@Param("field") String field, @Param("code") String code);
}
